home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 126-150 / scopedisk146 / autocli / autocli.doc < prev    next >
Encoding:
Text File  |  1995-03-19  |  5.6 KB  |  135 lines
  1.  
  2.             AutoCLI V1.6 17th June 1990 by Nic Wilson
  3.             -----------------------------------------
  4.                   
  5. This program has been placed on the Public Domain for your enjoyment. 
  6. Permission is hereby given to distribute this program in any 
  7. way you see fit, as long as this doc file accompanies it.
  8. Please send any bug reports or ideas (and spare money) to the
  9. address at the bottom of this file.
  10.  
  11. Commercial companies may also distribute the program, as long
  12. as the program is free of charge and all files accompany it.
  13.  
  14. PROGRAM SUMMARY
  15. ---------------
  16. This program was written because of problems with the similar
  17. program I have been using called 'popcli'.  Popcli crashes if used
  18. under WorkBench/KickStart 2.0, and also if used on a PAL Amiga to
  19. open a CLI window with a vertical size greater than 200 lines, it
  20. will not open if your Amiga decides to start in NTSC mode as they
  21. sometimes do,  Popcli also seems to steal CPU time when waiting and
  22. doesn't allow you to remove it from memory without crashing or a 
  23. reboot. AutoCLI overcomes all of the above problems and was written 
  24. in 100% Assembler using Devpac Amiga V2.14.
  25. The program is very quick, as hand coded assembler is definately
  26. the best way to program.  The code is very small and executes very 
  27. fast as compared to coding in 'C' or other language, as the code 
  28. generated would be much larger and slower. 
  29.  
  30. PROGRAM USAGE FOR INSTALLING AutoCLI
  31. ------------------------------------
  32. AutoCLI [<optional switches>] [<optional command>]
  33.  
  34. It DOES NOT require RUN or RUNBACK as it will return the command
  35. line and allow the window it was launched from to close, when an
  36. ENDCLI command is given.
  37.  
  38. The program is mainly be designed to be used in your startup-sequence
  39. so you will always have a CLI window available very easily.  For best
  40. results place the program in your C: directory
  41.  
  42. OPTIONAL SWITCHES
  43. -----------------
  44. -f          This switch enables function key trapping.  Default is OFF but
  45.             if the -f switch is found then it is turned on.  When the 
  46.             qualifier (see below) is held down and a function key pressed 
  47.             the program will execute a script file in the assigned S: 
  48.             directory with a filename of AutoCLI.F1, AutoCLI.F2 etc.
  49.             This file must be a standard script file (eg startup-sequence).
  50.     
  51. -s  -c  -a  The default qualifier key is the LEFT AMIGA but this can be 
  52.             changed with a switch.  The -s switch changes the qualifier 
  53.             key to the SHIFT key, The -c switch changes it to the CONTROL 
  54.             key and the -a switch changes it to the ALT key.  To use the 
  55.             default key (LEFT AMIGA) then don't use any of these three 
  56.             switches.  Note that this qualifier key is also the same for 
  57.             the autocli function aswell.
  58.             
  59. -r        The above qualifier is, by default, the key on the LEFT side
  60.         of the keyboard.  to change this to the RIGHT side, use this
  61.         switch.                  
  62.  
  63. ?        If the switch is a single question mark, then AutoCLI
  64.         will display a USAGE string on the current CLI window.  
  65.         It will not install or remove itself.
  66.         
  67.         
  68. OPTIONAL COMMAND
  69. ----------------
  70. If no optional command is given then AutoCLI will use a default command.
  71. If AutoCLI is already in memory it will be removed and all parameters
  72. will be ignored.  If AutoCLI is not in memory then it will launch and 
  73. wait for the qualifier key and ESCAPE to be pressed.  When this event 
  74. occurs AutoCLI will open a CLI window 1 pixel less than the size of the 
  75. WorkBench Screen, allowing the WorkBench window to be more easily 
  76. selected without having to resize the window.  If NEWCON: is available, 
  77. then a Shell window will open instead of a CLI window.
  78.  
  79. If an optional command is given, then AutoCLI will execute that command
  80. in preference to the default command when the qualifier key and ESCAPE is
  81. pressed (see EXAMPLES).  This allows custom commands or custom size 
  82. CLI/Shell windows to be used, but note that if AutoCLI is already 
  83. in memory it will ignore the optional command and remove AutoCLI from 
  84. memory.
  85.  
  86. Whenever AutoCLI is removed from memory, a message to that effect will
  87. be displayed on the current CLI window.
  88.  
  89. EXAMPLE  
  90.     AutoCLI -f -r -s newshell newcon:0/10/640/150/MyShellWindow
  91.     (opens a Shell window with a title of 'MyShellWindow', enables
  92.     function keys, and selects the RIGHT SHIFT as the qualifier).
  93.     
  94.     AutoCLI -f
  95.     (opens the default window with a title of 'AutoCLI V1.6'
  96.      and enables function keys.  The qualifer will be the 
  97.      default of LEFT AMIGA)
  98.                    OR
  99.     (if already installed it will be removed (switch ignored))                   
  100.  
  101. NOTE:  The command can of course be any executable file that
  102.        is normally used from CLI, it does not have to be used 
  103.        to open CLI windows, but can be used to launch any
  104.        program you wish.
  105.  
  106. REQUIREMENTS
  107. ------------
  108. The following commands MUST be available in the current C: directory         
  109.  
  110. run        ;c directory (called by the DOS Execute function)
  111. newcli         ;c directory (called by AutoCLI if NEWCON not available)
  112. newshell    ;c directory (called by AutoCLI if NEWCON is available)
  113. AutoCLI        ;c directory
  114.  
  115. The following commands, devices, files are optional
  116.  
  117. cli-startup    ;s directory (script executed by Newcli)
  118. shell-startup   ;s directory (script executed by NewShell)
  119. NEWCON:        ;(must be mounted to enable Shell instead of CLI)
  120. AutoCLI.F1    ;s directory (script file for qualifier/F1)
  121. AutoCLI.F2    ;s directory (script file for qualifier/F2)
  122. etc
  123.  
  124. Nic Wilson Software
  125. 138d South Street
  126. TOOWOOMBA Queensland 4350
  127. Australia
  128.  
  129. Phone (076) 358539  Home
  130.       (076) 358522  Work
  131.       (076) 358522  Fax
  132.       
  133.  
  134.                   
  135.